.. _cmcGnGetCommStates:

cmcGnGetCommStates
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmcGnGetCommStates ([in] VT_I4 BoardID, [in] VT_I4 Axis, 
    [in] VT_I4 cmctsId, [out] VT_PI4 CommStsVal)

DESCRIPTION
`````````````  

- cmcGnSetCommStates() 함수는통신 상태를 설정합니다. cmctsId에 따라 현재 통신 상태, 
  Real Time State Update Count 또는 Command Count 등을 설정할 수 있습니다.  
  cmcGnGetCommStates ()함수는통신 상태를 설정합니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의 첨두어 
  cmc가 붙지 않습니다.  


PARAMETER
```````````````

▶ BoardID: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis: Axis 번호, 축 번호는 3부터 시작합니다.. 
 
▶ cmctsId : 이 매개변수를 이용하여  어떤 통신 상태를 설정할 것인지를 선택합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   0 또는 cmcCSID_COM_STATES, 현재 통신 상태
   1 또는 cmccSID_RTS_COUNT, Real Time State Update Count
   2 또는 cmcCSID_CMD_RST, Command Count
   3 또는 cmcSCID_COM_RST, 통신 리셋 (설정만 가능)

▶ CommStsVal: 선택한 cmctsId에 따라 각각 현재 통신 상태, Real Time State Update Count, 
Command Count값을 설정합니다. cmctsId의 값으로 cmcCSID_RTS_COUNT, 
cmcCSID_CMD_COUNT를 선택한 경우에는 상수값, cmcCSID_COM_STATES를 선택한 
경우에는 -1~4의 값을 사용할 수 있으며 그 의미는 다음과 같습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   -1 또는 cmcCOM_STATE_RESET, 통신 리셋
   0 또는 cmcCOM_STATE_INIT, 통신 초기화
   1 또는 cmcCOM_STATE_WAITING, 통신 대기
   2 또는 cmcCOM_STATE_PREPARING, 통신 준비 
   3 또는 cmcCOM_STATE_START, 통신 시작 
   4 또는  cmcCOM_STATE_RUNNING, Running 

▶ cmctsId : 이 매개변수를 이용하여  어떤 통신 상태를 반환할 것인지를 선택합니다.

▶ CommStsVal: 선택한 cmctsId에 따라 각각 현재 통신 상태, Real Time State Update Count, 
Command Count값을 반환합니다. cmctsId의 값으로 cmcCSID_RTS_COUNT, 
cmcCSID_CMD_COUNT를 선택한 경우에는 상수값, cmcCSID_COM_STATES를 선택한 
경우에는 -1~4의 값이 반환될 수 있으며 그 의미는 다음과 같습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   -1 또는 cmcCOM_STATE_RESET, 통신 리셋
   0 또는 cmcCOM_STATE_INIT, 통신 초기화
   1 또는 cmcCOM_STATE_WAITING, 통신 대기
   2 또는 cmcCOM_STATE_PREPARING, 통신 준비 
   3 또는 cmcCOM_STATE_START, 통신 시작 
   4 또는  cmcCOM_STATE_RUNNING, Running 

   
RETURN VALUE 
````````````````

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   음수, 수행 실패.
   ERR_NONE, 수행 성공.